home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / files / userLog.man < prev   
Encoding:
Text File  |  1989-02-16  |  2.5 KB  |  62 lines
  1. ' Copyright 1989 Regents of the University of California
  2. ' Permission to use, copy, modify, and distribute this
  3. ' documentation for any purpose and without fee is hereby
  4. ' granted, provided that this notice appears in all copies.
  5. ' The University of California makes no representations about
  6. ' the suitability of this material for any purpose.  It is
  7. ' provided "as is" without express or implied warranty.
  8. ' 
  9. ' $Header: /sprite/src/man/files/RCS/userLog.man,v 1.1 89/02/16 10:04:22 ouster Exp $ SPRITE (Berkeley)
  10. ' 
  11. .so \*(]ltmac.sprite
  12. .HS userLog files
  13. .BS
  14. .SH NAME
  15. /sprite/admin/userLog, /sprite/admin/lastLog \- files containing information about user logins
  16. .SH DESCRIPTION
  17. .PP
  18. Each time a user logs into a sprite host, the system records
  19. information about the login in two files.  Each record in each file is
  20. a fixed-length ASCII string, so a particular record
  21. may be updated without the need to read and rewrite all other records
  22. in the file. 
  23. .PP
  24. One file records information on a per-host basis, while the other
  25. records information about the last login of each user.  The per-host
  26. file, \fB/sprite/admin/userLog\fP, has one record for each ``port'' of
  27. each host.  The ports are numbered, with port 0 reserved for the
  28. console of each host and ports 1-N corresponding to rlogin
  29. pseudo-devices 1-N.  The per-user file, \fB/sprite/admin/lastLog\fP,
  30. has one record per registered user, indexed by the userID in
  31. \fB/etc/passwd\fP.  
  32. .PP
  33. When a user logs in, the record for the user's last login is updated
  34. to show the new login.  The record for the host and port into which
  35. the user logs in is updated with the same information.  When the user
  36. logs out, the latter record is invalidated to show no one is currently
  37. logged in on that port, but the record for last login is updated only
  38. when the user logs in again.
  39. .PP
  40. Each record contains the following information, separated by white
  41. space:
  42. .IP valid 14
  43. Whether the entry corresponds to a current login.
  44. .IP hostID 14
  45. Host on which user logged in.
  46. .IP portID 14
  47. Port on this host on which user logged in.
  48. .IP time 14
  49. time at which user logged in, or 0 when record is invalidated.
  50. .IP location 14
  51. string indicating other host from which rlogin occurred, or empty.
  52. .PP
  53. Although the information is stored in ASCII format, to make it
  54. sharable by machines with different byte orderings, internally the
  55. user log is accessed via routines that convert between ASCII
  56. and an internal C structure.  Refer to the documentation for the
  57. \fBulog\fP library for information about this structure.
  58. .SH "SEE ALSO"
  59. ulog, db, login, finger
  60. .SH KEYWORDS
  61. database, user log
  62.